Transferência externa TED

Uma transferência TED é muito semelhante a uma transferência Pix com conta bancária, mas usa um sistema diferente e só será processada em dias úteis até às 17:00, horário de Brasília.

Request

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers/ted' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--header 'IdempotencyKey: {{guid}}' \
--data '{
  "amount": 0.01,
  "description": "test",
  "beneficiary": {
    "participantIspb": "00000000",
    "branch": "0001",
    "holder": {
      "document": "12345678901",
      "email": "[email protected]",
      "name": "Teste da Silva"
    },
    "number": "210001953"
  }
}'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.
IdempotencyKey	Obrigatório. Chave idempotência da requisição. Informe um GUID, sendo um novo cada requisição.

Corpo da requisição

Nome	Type	Descrição
amount	number	Obrigatório. Valor da transferência
description	string	Descrição sobre a transferência, somente para uso interno
beneficiary	object	Obrigatório. Objeto contendo informações sobre o beneficiário da transação
participantIspb	string	Obrigatório. Código ISPB da conta bancária do cliente beneficiário.
branch	string	Obrigatório. Agência da conta beneficiária
number	string	Obrigatório. O número da conta
holder	object	Obrigatório. Objeto contendo informações sobre o titular da conta beneficiária
document	string	Obrigatório. CPF ou CNPJ do titular da conta beneficiária
email	string	Obrigatório. E-mail do titular da conta do beneficiário
name	string	Obrigatório. Nome completo do titular da conta do beneficiário

Resposta

O status code 200 indicará sucesso na transação.

Sendo bem-sucedido, o retorno trará os seguintes campos no formato JSON:

Note

🚧 Essas informações serão retornadas após a criação da transferência e a consulta de transferência.

{
    "id": "{id}",
    "status": "DONE",
    "type": "TED",
    "amount": 0.01,
    "createdAt": "2025-02-10T12:48:20.695Z",
    "description": "Test",
    "payer": {
        "number": "{payer_account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    },
    "beneficiary": {
        "number": "{account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    }
}